/**
 * Copyright (c) 2013-2022 Nikita Koksharov
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.redisson.client.protocol.decoder;

import java.util.LinkedHashMap;
import java.util.List;

import org.redisson.client.codec.Codec;
import org.redisson.client.codec.StringCodec;
import org.redisson.client.handler.State;
import org.redisson.client.protocol.Decoder;


/**
 * 多解码器接口，用于支持对多种类型的解码操作。
 */
public interface MultiDecoder<T> {

    /**
     * 根据给定的参数获取解码器。
     * 此方法提供了一个默认实现，以确保在未指定codec时，能够使用StringCodec进行解码。
     */
    default Decoder<Object> getDecoder(Codec codec, int paramNum, State state) {
        if (codec == null) {
            codec = StringCodec.INSTANCE;
        }
        return codec.getValueDecoder();
    }


    /**
     * 对给定的parts列表进行解码操作，返回解码后的目标类型对象。
     * @param parts 待解码的对象列表。
     * @param state 解码状态，包含了解码过程中的必要信息。
     * @return 解码后的目标类型对象。
     */
    T decode(List<Object> parts, State state);


    /**
     * 创建一个LinkedHashMap实例，用于存储解码后的数据。
     * 此方法提供了一个优化的初始化容量计算，以确保map的性能和空间利用率。
     * @param expectedSize 预期的map大小，用于计算初始容量。
     * @param <K>          键的类型。
     * @param <V>          值的类型。
     * @return 返回一个新的LinkedHashMap实例。
     */
    static <K, V> LinkedHashMap<K, V> newLinkedHashMap(int expectedSize) {
        if (expectedSize < 3) {
            return new LinkedHashMap<>(expectedSize + 1);
        }
        return new LinkedHashMap<>((int) Math.ceil(expectedSize / 0.75));
    }

}

